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SECTION  1  -  INTRODUCTION 


This  manual  provides  the  guidelines  for  the  installation  and 
maintenance  of  the  DCA  Upper  Level  Protocol  Test  System  for  the 
standard  high-level  protocols  (IP,  IPSO,  TCP,  TCP-IP,  FTP,  SMTP 
and  Telnet ) . 

The  protocol  test  system  is  made  up  of  six  subsystems: 

o  ULTRIX  (Unix  BSD4.2)  Operating  System  Test  Kernel  (Test  System 
UNIX) 

o  Laboratory  Slave  Drivers 

o  Test  Scenarios  and  required  auxiliary  files 
o  Laboratory  Test  Reference  Implementations 
o  Report  Generator 
o  Man-Machine  Interface 

These  subsystems  are  organized  under  two  directories.  The  Test 
Kernel  is  in  directory  NETTEST  and  the  other  subsystems  are  in 
subdirectories  of  the  directory  tsl. 

Section  2  of  this  manual  describes  the  Protocol  Test  Reference 
UNIX  (TRU) .  Section  3  describes  the  tsl  directory  structure  and 
provides  a  reference  guide  to  the  required  files  in  each 
directory.  Section  4  details  the  environment  and  directory 
structure  provided  each  testing  client.  Section  5  contains  the 
installation  instructions  for  the  DCA  Upper  Level  Protocol  Test 
System  and  Section  6  details  the  steps  required  to  build  a  client 
testing  environment.  ✓ _ 
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SECTION  2  -  THE  PROTOCOL  TEST  REFERENCE  UNIX  ( TRU ) 


The  TRU  kernel  is  a  modified  Ultrix  Kernel.  Installation  of  the 
TRU  kernel  requires  replacing  some  files  from  the  standard  Ultrix 
VI. 1  distribution  with  new  versions  of  these  files,  adding  a  few 
others,  and  rebuilding  the  modified  Ultrix  Kernel.  See  Appendix 
A  for  the  added  or  modified  file  list.  These  replacement  files 
are  provided  to  the  System  Administrator  as  object  (*.o)  files 
and  are  all  involved  in  Ultrix's  networking  code. 


The  DC A  Upper  Level  Protocol  Test  System  kernel  includes  all  the 
functions  of  the  standard  kernel.  You  may  run  normal  UNIX  4.2 
applications  transparently  when  the  TRU  kernel  is  running. 


SECTION  3  -  PROTOCOL  TEST  SYSTEM  COMPONENTS 


The  tsl  directory  structure  is  shown  in  Figure  3-1.  All  of  the 
protocol  test  system  except  for  the  Test  Reference  UNIX  (TRU) 
kernel  code  is  found  under  the  tsl  directory. 

Table  3-1  is  a  list  and  a  description  of  the  files  in  the  tsl 


Table  3-1  -  TSL  FILES  (1  of  15) 
Path  and  File  Name _ Description 

tsl 


Make-bld-iut 

Make-rm-dir 

Make-bid-set 


Make-ch-one 


Make-ln-sof t 


Shell  to  set  up  client  directories. 
Shell  to  delete  client  directories 
(called  by  Make-bld-iut). 

Shell  to  build  client  test  and  rslt 
directories 

(called  by  Make-bld-iut). 

Shell  to  set  permissions  in  client 
directories 

(called  by  Make-bld-iut) . 

Shell  to  set  up  links  from  client 
directories  to  tsl  files 
(called  by  Make-bld-iut) . 


/drivers 

/tcp/lab/bin 

tcp_lab_dr iver  tcp  and  tcp-ip  driver  -  listens 

on  port  2002 


/smtp/lab/bin 

smtp_lab_dr iver  smtp  driver  and  receiver  reference 

driver  listens  on  port  1030 

smtp  receiver  listens  on  port  1051 


/ftp/lab/bin 

f tp_server_dr i ver  ftp  server  driver  -  listens  on 

port  1201 

f tp_user_dr i ver  ftp  user  driver  -  listens  on 

port  1204,  port  1203,  and  port  1202 


f tp_3way_ser ver _dr iver 


ftp  server  driver  -  listens  on 
port  1205 


Table  3-1  -  TSL  FILES  (2  of  15 


Path  and  File  Name _ 

tsl 

/drivers 

/telnet/lab/bin 

telnet_server_dr iver 

telnet  user  driver 


/ipso/lab/bin 

ipso_lab_dr iver 

/ip/lab/bin 

ip_lab_dr iver 

/ref 

/telnet/bin 

telnet 

tnd 


/ftp/bin 
f  tpd 

f  tp3d 

uf  tp 


Description 


telnet  server  driver  -  listens  on 
port  1203 

telnet  user  driver  -  listens  on 
port  1202 

ip  security  test  driver  -  listens 
on  port  2022 

ip  driver  -  listens  on  port  4000 


user  telnet  reference 
server  telnet  reference  - 
listens  on  port  1211 

server  ftp  reference  - 
listens  on  port  1210 
server  ftp  reference  - 
listens  on  port  1209 
user  ftp  reference 


tsl 

/test 

/ip/bin 


I P_BAS IC 
IP  FRAGMENTS 


ip  scenario 
ip  scenaro 


Table  3-1  -  TSL  FILES  (3  of  15) 

Path  and  File  Name _ Description 

tsl 

/test 

/ip/bin 


IP_EXTEND 

ip 

scenario 

IP_NOP 

ip 

scenario 

I P_STREAMOPT 

ip 

scenario 

IP_TIMESTAMP1 

ip 

scenario 

IP_TIMESTAMP2 

ip 

scenario 

IP_RECRO(JTE 

ip 

scenario 

IP_STRICTSR 

ip 

scenario 

IP_LOOSESR 

ip 

scenario 

IPOPTIONS 

ip 

scenario 

IP_ICMP 

ip 

scenario 

T0PD0WNBASIC1 

ip 

scenario 

TOPDOWN_BASIC2 

ip 

scenario 

TOPDOWN_NOP 

ip 

scenario 

TOPDOWN_RECROUTE 

ip 

scenario 

TOPDOWN_STREAMOPT 

ip 

scenario 

TOPDOWN_STR ICTSR 

ip 

scenario 

TOPDOWN_LOOSESR 

ip 

scenario 

TOPDOWN_T IMESTAMP 

ip 

scenario 

TOPDOWN_OPTIONS 

ip 

scenario 

/ip/aux 
test . ndx 

scenar io . ndx 


input_f ields 


Description  of  ip  tests  required 
for  Report  Generator 
Description  of  ip  scenarios 
required  for 

Man-Machine- Inter  face (MMI ) 
Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  MMI 


templa  tel 


Table  3-1  -  TSL  FILES  (4  of  15) 

Path  and  File  Name _ Description 

tsl 

/test 

/ip/aux 


IP_BASIC. toe 

Description  of 

tests 

IP_FRAGMENTS . toe 

Description  of 

tests 

IP_EXTEND. toe 

Description  of 

tests 

IP_NOP. toe 

Description  of 

tests 

IP_STREAMOPT. toe 

Description  of 

tests 

IP_TIMESTAMP1 . toe 

Description  of 

tests 

I P_T IMESTAMP2 . toe 

Description  of 

tests 

I P_RECROUTE . toe 

Description  of 

tests 

IP_STRICTSR . toe 

Description  of 

tests 

IP_LOOSESR. toe 

Description  of 

tests 

IP_OPTIONS. toe 

Description  of 

tests 

IP_ICMP. toe 

Description  of 

tests 

T0PD0WN_BASIC1 . toe 

Description  of 

tests 

T0PD0WN_BASIC2 . toe 

Description  of 

tests 

TOPDOWN_NOP . toe 

Description  of 

tests 

TOPDOWN_RECROUTE . toe 

Description  of 

tests 

TOPDOWN_STREAMOPT . toe 

Discription  of 

tests 

TOPDOWN_ STRICTSR . toe 

Description  of 

tests 

TOPDOWN_LOOSESR . toe 

Description  of 

tests 

TOPDOWN_TIMESTAMP. toe 

Description  of 

tests 

TOPDOWN_OPTIONS . toe 

Description  of 

tests 

/tep/bin 

ALLOC 

tep  scenario 

BASIC 

tep  scenario 

CLOSE 

tep  scenario 

MULTIPLEX 

tep  scenario 

OPEN 

tep  scenario 

OUT  OF  BAND 

tep  scenario 

in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
in  scenario 
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/tcp/aux 
test . ndx 

scenario . ndx 


input_f ields 

templatel 

template2 

ALLOC . toe 
BASIC . toe 
CLOSE . toe 
MULTIPLEX. toe 
OPEN. toe 
OUT_OF_BAND. toe 
POLICY. toe 
QUAL. toe 
RELIABILITY. toe 
RESET. toe 
SECURITY. toe 


Description  of  tep  tests  required 
for  Report  Generator 
Description  of  tep  scenarios 
required  for 

Man-Machine- Inter f ace (MMI ) 

Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  MMI 

Scenario  input  template  required 
for  MMI 

Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
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Table  3- 


Path  and  File  Name 


1  -  TSL  FILES  (6  of  15) 
Description 


/test 

/tcp-ip/bin 
IP_BASIC 
FRAGMENTS 
ICMP 
BASIC 
EXTEND IP 
OPEN 
CLOSE 

RELIABILITY 

MULTIPLEX 

SECURITY 

ALLOC 

POLICY 

OUT_OF_BAND 

RESET 

QUAL 


ip  scenario 
ip  scenario 
ip  scenario 
tcp  scenario 
ip  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 
tcp  scenario 


/tcp-ip/aux 
test . ndx 

scenario.ndx 


input_f ields 


templatel 


template2 


Description  of  tcp-ip  tests 
required  for  Report  Generator 
Description  of  tcp-ip  scenarios 
required  for 

Man-Machine-Interface(MMI ) 

Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  MMI 

Scenario  input  template  required 
for  MMI 


Table 

Path  and  File  Name 
tsl 
/test 

/tcp-ip/aux 

IP_BASIC. toe 
FRAGMENTS . toe 
ICMP. toe 
BASIC. toe 
EXTENDIP. toe 
OPEN. toe 
CLOSE . toe 
RELIABILITY. toe 
MULTIPLEX. toe 
SECURITY. toe 
ALLOC. toe 
POLICY. toe 
OUT_OF_BAND . toe 
RESET. toe 
QUAL. toe 

/telnet-user/bin 
USER_BASIC 
USER_0PTI0NS1 
USER_0PTI0NS2 
USER  SYNCH 


3-1  -  TSL  FILES  (7 
Description 


Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

Description 

scenario  to 
scenario  to 
scenario  to 
scenario  to 


of  15) 


of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

of 

tests 

in 

scenai io 

of 

tests 

in 

scenario 

of 

tests 

in 

scenario 

test  user  telnet 
test  user  telnet 
test  user  telnet 
test  user  telnet 


/telnet-user/aux 
test . ndx 

scenario. ndx 


Description  of  telnet  tests 
required  for  Report  Generator 
Description  of  telnet  scenarios 
required  for  Man-Machine-Interface 
Ordered  list  of  input  fields 
required  by  scenarios 


input_f ields 
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Table  3- 

Path  and  File  Name 


1  -  TSL  FILES  (8  of  15) 
Description 


tsl 

/test 

/telnet-user/aux 

templatel 

input_f ields 

templatel 

USERBASIC . toe 
USER_0PTI0NS1 . toe 
USER0PTI0NS2 . toe 
USER_SYNCH. toe 

/telnet-server/bin 


Scenario  input  template  required 
for  Man-Machine-Interface 
Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  Man-Machine-Interf ace 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 


SERVERBASIC 
SERVER_0PTI0NS1 
SERVER_0PTI0NS2 
SERVER  SYNCH 


scenario  to 
scenario  to 
scenario  to 
scenario  to 


test  server 
test  server 
test  server 
test  server 


telnet 

telnet 

telnet 

telnet 


/telnet-server /a ux 
test . ndx 


scenario. ndx 


input_f ields 


templatel 


SERVER_BASIC. toe 
SERVER_0PTI0NS1 . toe 
SERVER_0PTI0NS2 . toe 
SERVER  SYNCH. toe 


Description  of  telnet  tests 
required  for  Report  Generator 
Description  of  telnet  scenarios 
required  for  Man-Machine-Interface 
Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  Man-Machine-Interface 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 


Table  3-1 
Path  and  File  Name _ 

tsl 

/test 

/ftp-user/bin 

FILE_XFER 

BASIC 

CONN_SERVICE 
FILE_SERVICE 
THREE  WAY 


TSL  FILES  (9  of  15) 
Description 


scenario  to  test  user  ftp 
scenario  to  test  user  ftp 
scenario  to  test  user  ftp 
scenario  to  test  user  ftp 
scenario  to  test  user  ftp 


/f tp-user/aux 
test . ndx 

scenario . ndx 

input_f ields 

templatel 

FILE_XFER. toe 
BASIC. toe 
CONN_SERVICE. toe 
FILE_SERVICE. toe 
THREE  WAY. toe 


Description  of  ftp  tests  required 
for  Report  Generator 
Description  of  ftp  scenarios 
required  for  Man-Machine-Interface 
Ordered  list  of  input  fields 
required  by  scenarios. 

Scenario  input  template  required 
for  Man-Machine-Interface 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 


/ftp-server/bin 

BASIC 

FILE_SERVICE 
CONN_SERVICE 
FILE_XFER 
NO  LOGIN 


scenario  to  test  server  ftp 
scenario  to  test  server  ftp 
scenario  to  test  server  ftp 
scenario  to  test  server  ftp 
scenario  to  test  server  ftp 
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Table  3-1  - 
Path  and  File  Name _ 

tsl 

/test 

/ftp-server /bin 
GEN_ERROR 
C_CONN_SERVICE 
C_FILE_SERVICE 
C_FILE_XFER 
C_MULTICONN 
THREE  WAY 


TSL  FILES  (10  of  15) 
Description 


scenario 

to 

test 

server 

ftp 

scenario 

to 

test 

server 

ftp 

scenar io 

to 

test 

server 

ftp 

scenario 

to 

test 

server 

ftp 

scenario 

to 

test 

server 

ftp 

scenario 

to 

test 

server 

ftp 

/f tp-server/aux 
test . ndx 

scenario. ndx 


input_f ields 


Description  of  ftp  tests  required 
for  Report  Generator 
Description  of  ftp  scenarios 
required  for 

Man-Machine-Interf ace (MMI ) 

Ordered  list  of  input  fields 
required  by  scenarios. 


templatel 

Scenario  input 

for  MMI 

template 

required 

BASIC. toe 

Description 

of 

tests 

in 

scenario 

FILE_SERVICE. toe 

Description 

of 

tests 

in 

scenario 

CONN_SERVICE. toe 

Description 

of 

tests 

in 

scenario 

FILE_XFER . toe 

Description 

of 

tests 

in 

scenario 

NO_LOGIN . toe 

Description 

of 

tests 

in 

scenario 

C_CONN_SERVICE. toe 

Description 

of 

tests 

in 

scenario 

C_FILE_SERVICE. toe 

Description 

of 

tests 

in 

scenario 

C_FILE_XFER . toe 

Description 

of 

tests 

in 

scenario 

C_MULTICONN. toe 

Descr iption 

of 

tests 

in 

scenario 

THREEWAY. toe 

Descr iption 

of 

tests 

in 

scenario 

BASIC 

SOML 

SAML 

SEND 

ASCII 

SYNTAXBAD 

REPLYBAD 

LONGLINE 


scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 
scenario  to  test  sender  smtp 


/smtp-sender/aux 
test . ndx 

scenario . ndx 


input_f ields 

templatel 

BASIC . toe 
SOML . toe 
SAML. toe 
SEND. toe 
ASCII . toe 
BAD_SYNTAX . toe 
BAD_REPLY . toe 
LONG  LINE. toe 


Description  of  ftp  tests  required 
for  Report  Generator 
Description  of  smtp  scenarios 
required  for 

Man-Machine- In ter f ace (MMI ) 

Ordered  list  of  input  fields 
required  by  scenarios 
Scenario  input  template  required 
for  MMI 

Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 
Description  of  tests  in  scenario 


T1 
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Table  3-1  -  TSL  FILES  (12  of  15) 
Path  and  File  Name _ Description 

tsl 

/test 

/smtp- receiver /bin 


TRANSACTIONS 

scenario 

to 

test 

receiver 

smtp 

MULTI-HELO 

scenario 

to 

test 

receiver 

smtp 

BASIC 

scenario 

to 

test 

receiver 

smtp 

LIMITS 

scenario 

to 

test 

receiver 

smtp 

NEG 

scenario 

to 

test 

receiver 

smtp 

RELAY 

scenario 

to 

test 

receiver 

smtp 

RELAY 3 

scenario 

to 

test 

receiver 

smtp 

RSET 

scenario 

to 

test 

receiver 

smtp 

RSETRCPT 

scenario 

to 

test 

receiver 

smtp 

RSETSAML 

scenario 

to 

test 

receiver 

smtp 

RSET_SOML 

scenar io 

to 

test 

receiver 

smtp 

SEND 

scenario 

to 

test 

receiver 

smtp 

TURN 

scenario 

to 

test 

receiver 

smtp 

OPTIONS 

scenario 

to 

test 

receiver 

smtp 

HOSTNAMES 

scenario 

to 

test 

receiver 

smtp 

MULTI_RCPT 

scenario 

to 

test 

receiver 

smtp 

MULTI_SMTP 

scenar io 

to 

test 

receiver 

smtp 

/smtp-receiver/aux 
test . ndx 

scenario. ndx 


input_f ields 
templatel 
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Path  and  File  Name _ Descr iption 

tsl 

/test 

/smtp-receiver/aux 


TRANSACTIONS. toe 

Description 

of 

tests 

in 

scenar io 

MULTI_HELO. toe 

Description 

of 

tests 

in 

scenario 

BASIC . toe 

Description 

of 

tests 

in 

scenar io 

LIMITS. toe 

Description 

of 

tests 

in 

scenario 

NEG. toe 

Description 

of 

tests 

in 

scenario 

RELAY. toe 

Description 

of 

tests 

in 

scenario 

RELAY 3 . toe 

Description 

of 

tests 

in 

scenario 

RSET . toe 

Description 

of 

tests 

in 

scenario 

RSET_RCPT. toe 

Description 

of 

tests 

in 

scenario 

RSETSAML. toe 

Description 

of 

tests 

in 

scenario 

RSET_SOML . toe 

Description 

of 

tests 

in 

scenario 

SEND. toe 

Descr iption 

of 

tests 

in 

scenario 

TURN. toe 

Description 

of 

tests 

in 

scenario 

OPTIONS. tOC 

Description 

of 

tests 

in 

scenario 

HOSTNAMES . toe 

Description 

of 

tests 

in 

scenario 

MULTI_RCPT. toe 

Description 

of 

tests 

in 

scenario 

MULT I_SMTP. toe 

Description 

of 

tests 

in 

scenario 

/ipso/bin 

IPSO  scenario  to  test  IPSO  security 


/ ipso/aux 
test . ndx 

scenario. ndx 


Description  of  ipso  tests  required 
for  Report  Generator 
Description  of  ipso  scenarios 
required  for 

Man-Machine- Interface (MMI ) 

Ordered  list  of  input  fields 
required  by  scenarios 


input_f ields 
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Table  3-1  -  TSL  FILES  (14  of  15) 
Path  and  File  Name _ Description 

tsl 


/test 

/ipso/aux 

templatel 


IPSO. toe 


/mmi/bin 


/ rpg/bin 
rpg 


/spool 

/input_queue 

/output_queue 


/data 

/testdata . f  tp 


p_f i le 
test_f i le 
ref_f ilel 
ref  file2 


Scenario  input  template  required 
for  MM I 

Description  of  tests  in  scenario 


mmi 

Man- 

-Machine-Interface  (MMI) 

helpl 

MMI 

help 

screen 

help2 

MMI 

help 

screen 

help3 

MMI 

help 

screen 

help4 

MMI 

help 

screen 

help5 

MMI 

help 

screen 

help6 

MMI 

help 

screen 

help7 

MMI 

help 

screen 

help8 

MMI 

help 

screen 

Report  Generator  (RG) 


Directory  required  for  smtp  testing 
Directory  required  for  smtp  testing 


Directory  of  data  files  required 

for  FTP  testing 

test  data  file 

test  data  file 

test  data  file 

test  data  file 


Table  3-1  -  TSL  FILES  (15  of  15) 
Path  and  File  Name _ Descr  iption 

tsl 
/data 

/ testdata . f  tp 
ref _f i le3 
exist_f i le 
tran  filel 


test  data  file 
test  data  file 
test  data  file 


/installationf iles  Directory  of  C  files  required  in 

installing  Protocol  Test  System 
File  containing  additions  to  the 
file  /etc/services 


add  to  services 


n  bin 
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A  A 

/  \  /  \ 
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SECTION  4  -  THE  CLIENT  TEST  ENVIROMENT 

The  DC A  Upper  Level  Protocol  Test  System  provides  an  insulated 
environment  for  each  client  during  testing.  The  system 
administrator  sets  up  two  accounts  for  each  client  and  all  test 
results  are  kept  in  those  account  directories.  Every  client  is 
assigned  a  two  letter  code  which  is  then  prefixed  to  the  strings 
"test"  and  "rslt"  forming  two  login  names.  A  group  id  is  also 
assigned  to  the  accounts.  (Section  6  contains  the  instructions 
for  setting  up  this  test  environment.)  The  .login  files  of  the 
accounts  present  them  with  the  Man-Machine  Interface  (MMI)  menu. 

The  DCA  ULP  Protocol  Test  System  provides  the  system 
administrator  with  a  shellscript  to  build  the  client's  home 
directories  and  the  required  test  directories  in  those  home 
directories.  Client  subdirectories  built  are: 

mmi , 
rpg  and 

a  directory  for  each  test  protocol 

( tcp , tcp-ip , ip , ipso ,  telnet-user , 
telnet-server,  ftp-user,  ftp-server 
smtp-sender,  smtp-receiver ) . 

The  mmi  and  rpg  directories  are  linked  to  the  mmi  and  rpg 
directories  in  the  tsl  tree.  The  test  protocol  directories  for 
the  login  xxtest  have  six  subdirectories: 

aux 

test 

ref 

drivers 
input 
output . 

The  aux,  test,  ref,  and  driver  subdirectories  are  linked  to  their 
respective  directories  in  the  tsl  tree.  The  input  and  output 
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directories  contain  the  particular  files  required  and  produced 
for  this  client.  The  output  directory  has  further  subdirectories 
for  each  test  execution  session  where  the  log  and  audit  trail 
files  for  each  test  are  placed. 

The  xxrslt  directory  contains  an  aux  and  an  output  subdirectory. 
The  aux  directory  is  linked  to  its  respective  aux  directory  in 
the  the  tsl  tree.  The  output  directory  is  linked  to  the  xxtest 
output  directory  for  that  protocol. 

Using  the  xxtest  login,  tests  may  be  run  and  their  results 
examined  through  the  Man-Machine- Inter  face  and  the  Report 
Generator.  The  xxrslt  login  only  allows  the  user  to  look  at  test 
results.  Clients  are  restricted  to  viewing  their  test  results 
only . 
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SECTION  5  -  INSTALLING  THE  DC A  UPPER  LEVEL  PROTOCOL  TEST  SYSTEM 

Follow  these  steps  to  install  the  DCA  Upper  Level  Protocol  (ULP) 
Test  System.  The  bold  text  marks  commands  the  operator  enters. 

1.  Back  up  your  system. 

2.  Load  the  DCA  ULP  Test  System  release  tape.  (Figure  5-1  shows 
the  contents  of  the  release  tape.) 

3.  Login  as  the  root. 

4.  cd  /  (change  to  the  root  directory.) 

5.  cp  vmunix  vmunix.STD  (copy  your  current  kernel  to  a  backup.) 

6.  tar  xv  (Extract  the  DCA  ULP  Test  System  files.) 

7.  cd  /usr/sys/conf  (Steps  8-10  will  be  done  in  this 
directory ) . 

8.  Copy  your  host's  current  configuration  file  to  file  NETTEST . 

9.  Edit  file  NETTEST:  Change  the  value  of  keyword  "ident"  to 

NETTEST.  (For  example:  ident  NETTEST). 

10.  /etc/config  NETTEST  (Build  the  make  file  for  the  DCA  ULP 
kernel . ) 

11.  cd  /usr/sys/NETTEST  (This  is  the  directory  where  the  DCA 
ULP  kernel  will  be  built.) 


12.  make  depend  (Run  make  to  add  dependencies  to  the  makefile 


13.  make  (Build  the  DCA  ULP  kernel.) 

14.  cp  vmunix  /vmunix  (Replace  the  standard  system  kernel  with 
the  DCA  ULP  kernel.  It  will  not  start  executing  until  the 
the  system  has  been  rebooted.) 

15.  Edit  the  file  /etc/services.  Add  the  file 
/usr/users/tsl/data/insta 1 la t ion_f i les/add_ to_ser vices 
to  /etc/services. 

16.  shutdown  -r  +1  (Reboot  the  system  to  run  the  DCA  ULP 
kernel . ) 

If  the  system  reboots  with  no  problems  continue,  otherwise  redo 

the  steps  above  until  the  system  boots  correctly. 

17.  Login  as  root. 

18.  Add  new  users  necessary  for  the  DCA  ULP  test  scenarios  to 
run  correctly.  These  new  users  are  test,  test2,  and  test3. 

19.  Copy  /usr/users/tsl/data/testdata . f tp/*  to  the  new  user 
directory  test. 

20.  Add  new  client  users  to  permit  testing.  (See  Section  6.) 


bin  bin  / 

\ 

/ 

\ 

/ 

\ 

installation 

testdata 

files 

ftp 

aux  bin  aux  bin  aux  bin 
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SECTION  6  -  SETTING  UP  CLIENT  TEST  ENVIRONMENT 

Follow  these  steps  to  build  the  test  environment  required  for 

client  testing. 

1.  Assign  a  2  character  alphanumeric  id  to  the  client. 

2.  Prefix  the  client  id  to  the  string  "test"  and  the  string 
"rslt"  to  form  two  client  login  name.  For  example  given  a 
client  id  of  xx,  the  login  names  would  be  xxtest  and  xxrslt. 

3.  Login  as  root. 

4.  Add  client  logins  to  /etc/passwd  using  vipw. 

Assign  the  login  names  to  the  same  group  number.  An  example 
of  the  two  login  names  in  the  password  file  would  be: 

xxtest :: 100 : 100 : Test  Client  Xray : /usr/users/xxtest : /bin/csh 
xxrslt :: 101 : 100 : Test  Client  Xray : /usr/users/xxrslt : /bin/csh 

5.  Add  client  group  id  to  file  /etc/group.  Every  group  name 
must  begin  with  the  prefix  iu.  For  example  the  group  name  of 
xxtest  and  xxrslt  might  be  iuxxtest. 

6.  Login  as  xxtest  and  assign  a  password  to  this  login  name 
using  passwd. 

7.  Login  as  xxrslt  and  assign  a  password  to  this  login  name 
using  passwd. 

8.  Login  as  root. 

9.  Change  directories  to  /usr/users/tsl. 

10.  Run  the  shell  script  Make-bld-iut .  You  will  be  prompted  for 
the  2  character  client  id  and  the  group  id.  (This  shell  file 
will  build  the  directories  necessary  for  client  testing.) 


APPENDIX  A  -  TEST  REFERENCE  UNIX  FILES 


The  following  files  have  been  added  or  modified  to  create  the  DCA 
ULP  Test  System  kernel  from  the  ULTRIX  kernel.  They  are  listed 
as  they  appear  in  the  configuration  file. 


nettest/in_proto . c 
nettest/init_sysent . c 
nettest/ip_icmp . c 
nettest/ip_ input . c 
nettest/ipoutput . c 
nettest/iptest . c 
nettest/ip_test2 . c 
nettest/r awcb . c 
net test/raw  ip . c 
nettest/rawtest . c 
nettest/rawrepor t . c 
nettest/rawipoutput . c 
nettest/sys_socket . c 
nettest/tcp_input . c 
nettest/tcp_output .  c 
nettest/tcp_repor t .  c 
nettest/tcp_subr .  c 
nettest/tcp_test .  c 
nettest/tcp_t imer . c 
nettest/tcp_usrreq. c 
nettest/uipc_socket . c 
nettest/uipc_socket2 .  c 
nettest/uipc_syscalls .  c 


optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Binary 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Binary 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Binary 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Binary 

optiona 

1 

inet 

Bina 

ry 

optiona 

1 

inet 

Bina 

ry 

